home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / PDPerror.z / PDPerror
Encoding:
Text File  |  1998-10-30  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPDDDDPPPPeeeerrrrrrrroooorrrr((((3333))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       PPPPDDDDPPPPeeeerrrrrrrroooorrrr((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      PDPerror, PDErrorString - obtain libpod execution error messages
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppoooodddd....hhhh>>>>
  13.  
  14.      vvvvooooiiiidddd PPPPDDDDPPPPeeeerrrrrrrroooorrrr((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ssss))));;;;
  15.  
  16.      cccchhhhaaaarrrr**** PPPPDDDDEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg((((iiiinnnntttt eeeerrrrrrrr____ccccooooddddeeee))));;;;
  17.  
  18.      eeeexxxxtttteeeerrrrnnnn iiiinnnntttt PPPPDDDDeeeerrrrrrrrnnnnoooo;;;;
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _P_D_P_e_r_r_o_r prints error messages to standard error in a format similar to
  22.      the standard C library function _p_e_r_r_o_r(_3_C). _P_D_E_r_r_o_r_S_t_r_i_n_g returns the
  23.      error string corresponding to the _l_i_b_s_p_o_o_l error code specified by
  24.      _e_r_r__c_o_d_e.  The function is similar to the C library function
  25.      _s_t_r_e_r_r_o_r(_3_C).
  26.  
  27.      If an error occurs during a _l_i_b_p_o_d function call, the global error
  28.      variable _P_D_e_r_r_n_o will be set with an error code.  The symbolic names for
  29.      these error codes are defined in _p_o_d._h.
  30.  
  31.      The value of _P_D_e_r_r_n_o is used by _P_D_P_e_r_r_o_r as an index to a table of error
  32.      messages. _P_D_e_r_r_n_o can be passed to _P_D_E_r_r_o_r_S_t_r_i_n_g to obtain the _l_i_b_p_o_d
  33.      error message corresponding to the error code.
  34.  
  35.      A call to _P_D_P_e_r_r_o_r will print the user-supplied string _s followed by a
  36.      colon (:), a space, and the error message corresponding to the current
  37.      value of _P_D_e_r_r_n_o. If the string _s is the NULL string (""), no colon or
  38.      space will be printed, only the error message.
  39.  
  40.      To be of most use, a call to _P_D_P_e_r_r_o_r should be made immediately
  41.      following the _l_i_b_p_o_d function which failed.
  42.  
  43. PPPPRRRRIIIINNNNTTTTEEEERRRR OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNNAAAALLLL EEEERRRRRRRROOOORRRRSSSS
  44.      The _P_D_P_e_r_r_o_r function only provides information about _l_i_b_p_o_d function
  45.      execution errors. Information about printer operational errors is not
  46.      provided by _P_D_P_e_r_r_o_r but rather by querying the printer database using
  47.      the _P_D_R_e_a_d_S_t_a_t_u_s and _P_D_R_e_a_d_I_n_f_o functions.
  48.  
  49. NNNNOOOOTTTTEEEE
  50.      The global variables _P_D_e_r_r_l_i_s_t and _P_D_n_e_r_r should no longer be referenced.
  51.      The function _P_D_E_r_r_o_r_S_t_r_i_n_g _s_h_o_u_l_d _b_e _u_s_e_d.
  52.  
  53. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  54.      PDReadStatus(3), PDReadInfo(3), libpod(3)
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.